home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / edit / me_cd.zip / ERRATA.DOC < prev    next >
Text File  |  1988-10-24  |  15KB  |  274 lines
  1. ========================================================================
  2. ==        ME Errata and machine/OS specifics    Craig Durland ==
  3. ========================================================================
  4.         
  5. ========================================================================
  6.         Supported versions of ME
  7. ========================================================================
  8.   FILE        NOTES
  9.   ----        -----
  10.   mepc.exe    PC, FV, Ansi, Snow
  11.   mepcs.exe    PC, SV, Ansi
  12.   meat.exe    AT, FV, Ansi, Snow
  13.   me150.exe    HP150, HP110, SV
  14.   mepp.exe    HP Portable Plus, FV, fonts & inverse video
  15.   I also have versions for HP 9000 Series 300 and 800 HPUX.
  16.   
  17.   Notes:
  18.     All  versions  of ME are Mutt  object code  compatible.  ie the .mco
  19.       files are the same no matter what machine you are running ME on.
  20.     The PC versions can use EGA 43 line mode.
  21.   Ansi = Requires ANSI.SYS or NANSI.SYS (a faster ANSI.SYS (which I can
  22.     supply)).
  23.   AT = IBM ATs or clones.  80286 code.  Somewhat faster and smaller.
  24.   FV = Fast video ie writes directly to video ram.
  25.   PC = IBM PCs, ATs, or clones.  8086 code.
  26.   Snow = Will snow the screen if you have a IBM color display card.
  27.     Most other cards do not have this problem.
  28.   SV = Slow video ie uses escape sequences.
  29.  
  30. ========================================================================
  31.             BUGS
  32. ========================================================================
  33.   MS-DOS
  34.     If you install TSRs (terminate and stay resident - things like Side
  35.       Kick) from within ME (ie ^X!  or from a shell invoked by ME) and
  36.       don't exit ME, there is a good chance that sometime later ME will
  37.       not be able to write out files (it will say something like "Error
  38.       closing file").  If this happens, you are screwed - your file is
  39.       cleared from the disk and there is no way you can save it.
  40.       Another symptom is problems allocating memory ("Cannot allocate x
  41.       bytes").  print.com is the only TSR I have verified causing these
  42.       problems but don't press your luck.
  43.       Note: is OK to use TSRs from within ME.  ie using print.com to
  44.       print a file while in ME is OK as long as print was installed
  45.       outside of ME.
  46.     EGA 43 line mode: If you are using nansi.sys, switching into 43 line
  47.       mode and then invoking a shell or running a program (^X!) the cursor
  48.       may disappear.  This is caused by a bug in nansi.sys.  When going
  49.       into 43 line mode it should set 40:87H bit 0 and clear that bit when
  50.       returning to 25 line mode but it don't.
  51.   UNIX
  52.     XON/XOFF can screw things up.  ME turns off XON/XOFF because XON is
  53.       ^S and XOFF is ^Q and most Emacs users are very attached to those
  54.       keys.  This can lead to terminal overruns if the terminal cannot
  55.       keep up at the baud rate selected or there is not enough padding.
  56.       Sometimes the connection to the computer runs though a server
  57.       device that also talks XON/XOFF.  If this is the case ^S will stop
  58.       the display and some times ME will start searching for no apparent
  59.       reason.  Talk to a guru and find out how to fix the server or
  60.       rebind ^S and ^Q to "" and use the alternate keys (^\ and ^^).
  61.     Softkeys:  Most terminals send escape codes when you press a function
  62.       key or softkey.  This is a problem when the codes overlap valid ME
  63.       user key sequences (eg HP terminals send "ESC B" for down arrow which
  64.       is also the ME sequence for (backward-word)).  The version of ME for
  65.       HP terminals (MEH), trys to tell the difference with timing, however,
  66.       this method if far from foolproof.  To tell if you have a problem,
  67.       type ^X^V (visit-file) and then press a function key (such as down
  68.       arrow) rapidly.  You should see
  69.       F-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-D.  If you don't or see
  70.       something like F-DM-BM-BF-DF-DM-B you have a problem and you have to
  71.       either give up softkeys or the mappings they cover.  Or get a
  72.       "better" terminal.  Regular ME leaves soft key processing to Mutt
  73.       pgms (see vt100.mut for an example).
  74.  
  75. =========================================================================
  76.         MS-DOS specifics
  77. =========================================================================
  78.   Filenames can contain "/" or "\".
  79.   Strango characters
  80.     MS-DOS ME allows you to enter ^Z or NULL (0) and write out the file but
  81.       a line with NULL in it gets truncated (at the NULL) when read in.
  82.    Some versions allow you to enter a character by typing in its decimal
  83.       value (eg "A" is decimal 65) (see below).  Note that entering most
  84.       keys is like pressing the key on the keyboard so you may want to
  85.       quote (^Q) the character.
  86.     IBM PC: hold down ALT and type the value on the number pad.  The
  87.       character is added when the ALT key is lifted.
  88.     Portable Plus: Put into Num pad mode (Extend Num), hold down Extend and
  89.       press the value on the number pad (the blue numbers).  The character
  90.       is added when the ALT key is lifted.  Now switch back to regular mode
  91.       (Extend Num).  This is easier to do than to say.
  92. * Portable Plus version:
  93.   The Clr dsp, +Line and -Line function key are not mapped.
  94. * HP150 version:
  95.   The function keys (f1...f8) don't work unless the user keys are turned
  96.     on AND f1 is programmed to send Normal ESCp, f2 Normal ESCq, ...  f8
  97.     Normal ESCw.  This is because of a bug in the 150.
  98.       This can be done with:
  99.     (puts "^[&f0a1k5d2L   f1^[p") (puts "^[&f0a2k5d2L   f2^[q")
  100.     (puts "^[&f3k0a5d2L   f3^[r") (puts "^[&f4k0a5d2L   f4^[s")
  101.     (puts "^[&f5k0a5d2L   f5^[t") (puts "^[&f6k0a5d2L   f6^[u")
  102.     (puts "^[&f7k0a5d2L   f7^[v") (puts "^[&f8k0a5d2L   f8^[w")
  103.     (puts "^[&jB")
  104.  
  105. ========================================================================
  106.         UNIX specifics
  107. ========================================================================
  108.   You can use csh style wildcards: ~, [], [^], ?, *
  109.       (eg ~craig, ~/tools, foo[123], foo*, etc) for (insert-file),
  110.       (read-file), (rename-buffer), (visit-file), (write-file) and
  111.       current-directory.
  112.     See dir.mut for examples of cwd, dirs, push directory, pop directory.
  113.  
  114. ========================================================================
  115.     Color, inverse video, fonts, etc
  116. ========================================================================
  117.   This is very machine dependent.  See modeline-color, text-color in
  118.     MEMUTT.DOC.
  119.   IBM PC fast video (CGA, EGA):
  120.     bit7-> |blink|R|G|B| |intensity|R|G|B| <-bit 0  (foreground)
  121.       where R=red, G=green, B=blue, blink makes the character blink and
  122.       intensity only affects the foreground color.
  123.     For example:
  124.       green foreground, blue background:  |0|0|0|1| |0|0|1|0| ==0x12 ==18
  125.       monochrome inverse video:  |0|1|1|0| |1|1|0|1| ==0x6D ==109
  126.   Portable Plus:
  127.     bit7-> |0|0|f1|f2| |0|underline|inverse video|blinking|
  128.       where f1f2 are the font selector: 00 for normal font, 01 for stick
  129.     For example: inverse video stick font: |0|0|0|1| |0|0|1|0| ==0x12 ==18
  130.   HP150, UNIX:
  131.     0: normal, 1: half bright inverse video.
  132.     Note:  If the color is set to something outside this range, you get
  133.       normal color for everything and slightly faster screen updates - 
  134.       ie the color stuff is ignored.  Do this if the color is screwing 
  135.       up your screen.
  136.   ANSI mode: This has been tested only on IBM PC like things.
  137.     The  format is xxyy.  xx is one  color  and yy is the  other.  These
  138.       numbers  come  from  the  ansi  spec  for the  ansi  set  graphics
  139.       rendition (SGR) escape sequence.
  140.     For example:  if 32 is green foreground, 41 red background and 44 is
  141.       blue background, then (text-color  3241)(modeline-color 4432) sets
  142.       green text on a red background  with the modeline  green text on a
  143.       blue background.
  144. * Screen size:
  145.   Sometimes the same code runs on machines with different screen sizes.
  146.     If this is your case, you'll need to resize the screen.
  147.   For example:
  148.     HP110:  use me150.exe and put (screen-length 16) in your init file.
  149.     EGA 43 line mode:  If you have a IBM PC,